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1.  INTRODUCTION 


This  manual  describes  the  HEVSIM  operating  commands  and 
methods  available  to  execute  a program.  The  methods  include  in- 
teractive operation,  batch  processing  from  a terminal,  and  batch 
processing  using  a card  deck.  Sample  runs  are  presented  for 
each  method.  The  input  data  format  is  described  and  sample 
output  data  are  listed. 

The  preference  for  one  method  of  operation  over  another  de- 
pends primarily  on  user  convenience.  For  example,  interactive 
operation  typically  requires  more  connect  time  at  a terminal 
than  batch  processing,  but  offers  the  advantage  of  maximum  con- 
venience when  modifying  components  to  determine  influences  on 
fuel  economy.  Batch  processing  requires  a HEVSIM  control  file 
(made  up  of  HEVSIM  operating  commands  and  parts)  which  must  be 
created  before  submitting  the  run,  but  offers  the  advantage  of 
executing  during  low  rate  off-peak  hours.  The  use  of  cards, 
rather  than  a terminal,  may  be  more  convenient  for  preparing  a 
HEVSIM  control  file  due  to  the  enumerated  column  headings,  es- 
pecially for  a user  not  accustomed  to  terminal  operation.  Sub- 
mitting cards  for  execution  of  HEVSIM,  however,  usually  becomes 
unnecessarily  cumbersome  once  a HEVSIM  control  file  is  in  a 
user's  disk  area.  More  conveniently,  the  user  may  submit  the 
HEVSIM  control  file  from  a terminal.  Once  a HEVSIM  control  file 
is  prepared,  many  variations  may  be  run  conveniently  from  the 
terminal . 

The  program  is  most  efficient  when  a large  scenario  is  being 
executed  in  such  a way  as  to  optimize  data  retrieval  from  the 
disk.  For  example,  a series  of  *USE  commands  could  be  used  to 
"construct"  the  vehicle  to  be  used  initially.  Then  a sequence  of 
alternating  *M0DIFY  and  ^SIMULATE  commands  would  allow  the  user 
to  try  ten  different  vehicle  weights  with  five  different  rear 
axle  ratios  and  so  forth.  This  would  require  no  further  disk 
accesses  and  would  accomplish  some  fifty  trials-.  At  that  point 
a different  driving  schedule  could  be  retrieved  from  the  disk  and 
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the  process  repeated  for  another  fifty  trials.  If,  on  the  other 
hand,  the  user  alternated  driving  schedules  for  each  *MODIFY  com- 
mand, the  program  would  use  a great  deal  more  time  to  retrieve 
data  from  the  disk  and  therefore  cost  more  to  run. 

The  default  time  step  of  .05  seconds  may  be  overridden 
with  a *MODIFY  command  to  perform  the  same  run  with  a longer 
time  step  in  order  to  cut  cost.  (Note:  Due  to  certain  toler- 

ances built  into  the  program,  a step  of  less  than  .05  is  not 
recommended. ) 
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2.  PROGRAM  EXECUTION 


A description  of  HEVSIM  execution  through  interactive  and 
non- interact ive  operational  modes  will  be  provided  in  this  sec- 
tion. Figure  1 shows  the  four  types  of  simulation  methods 
available  and  their  association  with  either  operational  mode. 

The  interactive  mode  permits  the  user  three  possible  simulation 
methods:  1)  interactive  simulation  in  which  the  user  is 

queried  or  directs  HEVSIM,  2)  attached  simulation  through  ex- 
ecution of  a HEVSIM  control  file  with  monitoring  at  the  termin- 
al; and,  3)  detached  simulation  through  submission  of  a batch 
control  file.  The  first  two  methods  permit  switching  control 
from  one  method  to  the  other  after  completion  of  each  run. 

The  non- interactive  mode  permits  the  submission  of  punched 

t 

card  batch  control  files.  The  card  deck  contains  a HEVSIM  con- 
trol file  and  instructions  to  execute  HEVSIM.  The  method  func- 
tions in  a manner  similar  to  detached  simulation,  except  for  the 
use  of  cards  instead  of  interactive  terminal  commands.  In  both 
the  interactive  and  non- interactive  modes  it  is  assumed  that 
HEVSIM  and  the  required  parts  to  be  accessed  are  already  on 
disk. 

SIMULATION  COMMAND  STRUCTURE 

HEVSIM  commands  for  both  interactive  and  non- interact ive 
operation  will  be  listed  and  described  in  this  section.  There 
are  many  commands  which  have  a common  name  and  produce  the  same 
result  for  interactive  and  non- interact ive  operation.  In  non- 
interactive operation,  however,  the  command  names  must  be  pre- 
fixed with  an  asterisk  (*)  to  complete  the  command.  The  ap- 
plicable command  names  that  apply  to  each  operational  mode  are 
listed  in  Table  1. 

The  function  of  each  command  name  will  be  described  next, 
along  with  any  specific  mode.  Hereafter,  the  interactive  op- 
erational mode  will  be  referred  to  as  IA,  and  the  non- interact ive 
mode  as  NIA.  By  HEVSIM  definition,  a command  name  is  an  actual 
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FIGURE  1.  OPERATIONAL  MODES  AND  SIMULATION  METHODS  DIAGRAM 


TABLE  1 


COMMAND  NAMES  APPLICABLE  TO  EACH  OPERATIONAL  MODE 


COMMAND 

ASK 

BATCH 

CONTINUE 

DEBUG 

DELETE 

DIALOG 

DIR 

DUMP 

INDIRECT  @ 

STOP  (EXIT) 

LIMIT  PRINT 

MODIFY 

REMAP 

RESET 

SIMULATE 

STATUS 

TITLE 

TTY  (LPT) 

LOCK  (UNLOCK) 

UNIT 

USE 

ZERO 


INTERACTIVE 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

t 

X 

X 

X 

X 

X 

X 

X 

X 


NON- INTERACTIVE 


X 

X 


X 

X 

X 

X 

X 

X 

X 

X 

X 

X 

X 


command  in  the  IA  mode,  and  an  asterisk  immediately  followed 
by  a command  name  (plus  specified  options  if  any)  is  a command 
in  NIA  mode.  During  simulation  in  the  IA  mode  commands  are 
typed  on  the  terminal,  while  for  the  NIA  mode  commands  are 
card  punched  starting  in  the  first  column  with  an  asterisk.  In 
the  command  descriptions  below,  the  abbreviation  (cr)  indicates 
the  carriage  return  in  IA  mode.  All  the  NIA  mode  command  formats 
are  specified  exactly  by  the  data  format  sheets  in  section 
4.2  These  descriptions  will  not  be  repeated  here. 

The  ASK  command  puts  HEVSIM  into  ASK  mode.  While  in  ASK 
mode,  HEVSIM  will  cycle  through  all  the  part  types,  querying  the 
user  as  to  the  particular  part  to  use.  When  all  parts  are  load- 
ed, HEVSIM  gives  the  user  the  option  of  going  directly  to  the 
simulation  or  not,  or  going  into  DIALOG  mode,  by  asking. ’’SIM- 
ULATE (Y/N/D)".  If  the  user  elects  not  to  simulate  (N) , HEVSIM 
will  ask  if  various  modifications  are  desired.  When  this  is 
completed  to  the  user's  satisfaction,  the  user  is  again  offered 
the  choice.  The  user  may  cycle  through  the  parts  and  modifi- 
cations until  the  simulation  parameters  are  as  he  wishes.  Then 
he  can  go  to  the  simulation  (Y)  or  into  the  DIALOG  (D)  mode. 

Use  of  the  INDIRECT  (@)  command  allows  the  user  to  enter 
HEVSIM  commands  from  a pre-made  HEVSIM  control  file  on  disk. 

This  option  is  especially  useful  for  production  running.  The 
command  is  used  in  the  following  fashion: 

DEV:  FILE.  EXT[P,PN]M  (cr) 

where  DEV : FILE .EXT [P ,PN]  is  the  general  file  decriptor  of  the 
batch  control  file.  The  makeup  of  the  batch  control  file  follows 
exactly  the  batch  commands  defined  in  this  manual. 

The  CONTINUE  command  is  used  only  if  an  error  occurs  while 
inputting  a HEVSIM  batch  control  file.  If  an  error  occurs,  the 
user  is  given  the  option  of  going  into  DIALOG  mode  and  fixing  the 
error,  or  skipping  the  faulty  card  and  continuing  with  the  control 
file.  Naturally,  the  CONTINUE  command  tells  HEVSIM  to  continue 
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processing  the  control  file. 

DEBUG  can  be  used  to  obtain  additional  information  beyond 
the  run  detail  printout.  It  is  very  useful  for  debugging  runs 
that  fail.  It  can  be  operated  in  four  modes: 

(1)  OFF  - turns  off  DEBUG  printout  entirely; 

(.2)  SHIFT  - prints  DEBUG  information  before  and  after 

each  shift  from  the  "start"  to  "stop"  segments,  and  is  good  for 
detecting  shift  stutters; 

(3)  TIME  - prints  DEBUG  information  for  the  .time  frame 
specified  by  "start"  and  "stop"  times; 

(4)  SEGMENT  - prints  DEBUG  information  from  the  "start" 
to  the  "stop"  segments. 

In  the  IA  mode,  DEBUG  is  activated  by  typing  "DEBUG"  (cr) . 
VEHSIM  will  type  "DEBUG":  indicating  that  it  is  in  DEBUG  mode. 
Then  enter  the  mode  and  start  and  stop  limits.  This  line  is  read 
using  a format  of  A5,2F  so  one  must  be  sure  to  enter  enough 
spaces  between  the  mode  and  the  start  limit.  DEBUG  output  for- 
mat comes  in  four  lines  containing  the  following  variables: 

line  1 CUMT,  CUMD,  V,  ACCEL,  FWHEEL , FROLL,  FAERO, 

FACCEL,  F GRADE:, 

line  2 DT,  NGEAR,  ISEG,  NRTSEG , TORQW,  TR,  TORQP , T0RQ2 , 
T0RQ1 , TORQF , TORQE: 

line  3 PCTWOT,  HIDNAM,  HPBR , RPMW,  DRPMW,  RPMP , RPM2 , RPME , 
DRPME ; 

line  4 NGOCAL,  MAPOK. 

These  variables  are  defined  in  Volume  III,  Appendix  I.  If 
no  "start"  limit  is  given,  DEBUG  will  start  at  the  start  of 
the  simulation-.  If  no  "stop"  limit  is  given,  DEBUG  will  con- 
tinue until  the  simulation  ends  or  aborts.  DEBUG  mode  will  re- 
main in  effect  for  all  SIMULATE  commands  until  it  is  changed 
by  another  DEBUG  command.  The  default  value  is  off.  The  user 
is  cautioned  against  using  DEBUG,  since  voluminous  printout  may 
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result . 


The  shift  debug  output  format  is  printed  in  the  following 
order: 

HSMODE,  HTMODE,  CUMTLS , CSTIM,  TORQA,  TORQAO , ATORQF, 

ARPME,  DRPM1E,  DRPMC,  DTC,  LCLTCH.  

This  data  is  printed  only  during  shifting. 

DELETE  AND  DROP  allow  the  user  to  delete  parts  from  the 
data  base.  Please  be  careful  when  using  this  command. 

The  DIALOG  command  places  HEVSIM  in  DIALOG  mode.  This 
means  that  HEVSIM  will  accept  commands  from  the  terminal  rather 
than  from  a disk  control  file. 

DIR  gives  a directory  of  the  data  base  parts  data.  The 
wild  card  construction  is  available.  The  directory  will  only 
be  printed  at  the  terminal  if  it  is  turned  on  via  the  TTY  com- 
mand. A sample  terminal  session  showing  use  of  DIR  is  given  in 
a later  section  of  this  manual. 

The  DUMP  command  allows  the  user  to  obtain  a dump  of  all 
| the  data  currently  stored  in  the  disk  parts  data  file.  For 

j 

interactive  users,. the  model  will  request  part  type  and  part 
name  information.  The  wildcard  construction  is  available.  A 
dump  is  a human  readable  form  of  the  parts  data.  A dump  will 
always  come  only  to  the  print  file  and  never  to  the  terminal. 

The  user  has  the  option  of  obtaining  a directory  at  the  same  time, 
and  the  directory  will  come  to  the  terminal  if  the  TTY  is  switched 
on  via  the  TTY  command.  A sample  terminal  session  using  DUMP 
is  provided  in  another  section  of  this  manual. 

In  NIA  mode  the  *DUMP  command  can  be  used  with  the  word 
DIRECTORY  beginning  in  column  19  to  obtain  a listing  of  only 
the  names  and  comment  fields  of  parts.  Using  only  *DUMP  gives 
a listing  of  all  the  data  in  the  disk  parts  data  file. 

The  STOP  and  EXIT  commands  close  all  data  base  files,  give 
the  user  the  option  of  how  to  dispose  of  the  print  file. 
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and  exit  to  the  monitor.  The  print  file  disposition  options 
are : 

DELETE  - delete  the  file 

SAVE  - save  the  file 

PRINT  - queue  the  file  for  printing  

LIMIT  PRINT  enables  the  user  to  limit  the  amount  of  printed 
output  he  wishes  to  receive  for  the  simulations  that  are  requested 
There  are  five  options  available: 

(1)  "SEGME"  - prints  out  detailed  output  only  for  the 

final  time  step  for  each  segment  of  the 
driving  schedule  as  well  as  the  initial 
conditions  step. 


(2)  "MILE” 


(3) 


'SEC' 


prints  out  detailed  output  at  fixed 

■e 

mileposts  along  the  schedule  (e.g., 
every  .1  mile)  as  well  as  the  initial 
conditions  step. 

prints  out  detailed  output  at  fixed  time 
increments  along  the  schedule  (e.g., 
every  10.  seconds)  as  well  as  the  initial 
conditions  step. 


(4) 


'OFF’ 


(5) 


prints  out  detailed  output  at  each  and 
every  time  step  in  the  simulation. 

'SUMMA"  - only  summary  sheet  at  end  of  simulation 
is  printed.  If  LIMIT  PRINT  is  off  when 
loading  parts  a dump  of  that  part  will 
appear  on  the  print  file. 

MODIFY  enables  the  user  to  reset  the  value  of  a number  of 
individual  program  parameters  without  creating  a new  component 
data  set  for  the  disk  file.  The  MODIFY  command  should  only  be 
used  after  the  USE  command,  which  retrieves  the  data  to  be  over 
ridden.  You  can  modify  several  simulation  parameters. 
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Keyword 


Result 


AREA 

Cl 

C2 

C4 

CD 

CYLINDER 

DIESEL 

DISPLACEMENT 
DUTY CYCLE 
DYNA 


DOWNSHIFT 

FUEL 

IDLE 

PHI 

REAR 

SHIFT 

STEP 

STROKE 

TIRE 

TRR 

UPSHIFT 

WEIGHT 

WHEEL 

WIND 


frontal  area  (sq.  ft.) 

1st  constant  in  rolling  resist,  equation 
2nd  constant  in  rolling  resist,  equation 
bearing  loss 

aerodynamic  drag  coefficient 
number  of  cylinders 
logical 

modifies  the  cubic  inch  displacement  of 
the  engine 

modifies  the  accessory  duty  cycle  from 
default  of  1. 

turns  on  the  dynamometer  testing  with  a 
value  of  1 and  turns  off  the  dynamometer 
with  a value  of  0. 

I change  in  vacuum/throttle  downshift 
level 

fuel  specific  gravity 
reset  the  idle  RPM 
reset  the  wind 
rear  axle  ratio 

available  for  debugging  the  program  only 
time  step  for  simulation  (sec.) 
piston  stroke  (in.) 
tire  efficiency 

front  end  rotating  inertia  (logical) 

% change  in  vacuum/throttle  upshift  level 
gross  weight  of  the  vehicle 
number  of  wheels 
wind  velocity  (WPH) 


In  the  IA  mode  the  user  is  queried  for  a new  value  followed  by  the 
keyword.  HEVSIM  continues  to  ask  for  the  new  value  and  keyword 
until  the  query  is  answered  by  a (CR) . 


*REMAP  allows  the  user  to  obtain  an  engine  map  printed  out 
at  the  speed  and  torque  points  that  he  specifies  rather  than  at 
the  points  that  were  initially  input.  This  capability  provides  a 
convenient  method  of  comparing  fuel  rates,  vacuums,  etc.,  between 
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engines  whose  initial  data  was  taken  at  different  points  in  the 
performance  map.  This  command  is  only  available  in  the  NIA  mode. 

RESET  is  executed  only  during  an  IA  simulation.  RESET  stops 
the  simulation  and  puts  HEVSIM  out  of  simulation  mode.  All  loaded 
parts  remain  loaded.  AS  in  the  EXIT  command,  the  user  is  given 
the  option  of  disposing  of  the  print  file.  However,  since  the 
file  is  to  be  closed  and  reopened,  the  effect  of  the  various 
options  are  somewhat  different: 

APPEN  - causes  the  new  print  file  to  be  appended  to  the 
old  print  file,  effectively  saving  what  has  been  done. 

DELETE  - deletes  the  old  print  file. 

SAVE  - saves  the  old  print  file,  but  the  closing  and 
reopening  causes  the  new  file  to  overwrite  the  old,  thereby 
destroying  the  old  print  file. 

SIMULATE  begins  the  actual  simulation.  It  first  checks  to 
see  that  all  the  necessary  parts  have  been  assembled  from  the  disk 
parts  data  file  by  means  of  USE  commands  or  new  parts  data  cards 
and  allows  the  vehicle  to  reach  initial  conditions  specified  by 
the  driving  schedule  itself.  At  the  end  of  the  simulation,  more 
USE  or  MODIFY  commands  may  be  used  to  bring  in  or  reset  data  for 
another  simulation,  and  so  forth,  until  the  end  of  the  input  data 
is  reached,  at  which  time  the  program  terminates  execution. 

The  STATUS  command  prints  out  the  status  of  the  simulation 
parameters,  including  the  parts  that  are  loaded,  and  all  modifica- 
tions. To  receive  the  status  report  at  the  user  terminal,  the 
terminal  must  be  turned  on  via  the  TTYP  command.  An  automatic 
status  report  is  generated  for  the  print  file  when  a SIMULATE 
command  is  given. 

TITLE  allows  the  user  to  specify  a 60  character  title  which 
will  appear  on  the  top  of  every  page  output  by  the  model.  Each 
TITLE  command  overrides  the  previous  one  so  that,  if  he  wishes, 
the  user  may  specify  a different  title  for  each  simulation  or  the 
same  title  for  all  simulations  performed  during  a single  run.  The 
date  to  be  printed  on  all  output  may  be  specified  here  to  override 
the  actual  date. 
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The  TTY  and  LPT  commands  allow  for  the  turning  on  or  off  of 
either  the  TTYP  or  LPT  output  while  in  IA  mode.  The  initial  state 
of  the  TTY  is  off  and  the  initial  state  of  the  LPT  is  on. 

LOCK  and  UNLOCK  provide  the  user  with  the  capability  of 
"locking  up"  or  "unlocking"  the  torque  converter  for  any  of  the 
gears  in  the  transmission.  LOCKUP  will  render  the  torque  con- 
verter invisible  by  setting  the  speed  and  torque  ratios  equal  to 
unity  and  zeroing  the  input  and  output  inertias  while  the  vehicle 
is  in  the  specified  gear(s) . UNLOCK  can  be  used  to  "unlock" 
a previously  "locked  up"  gear.  All  this  simply  means  that  a 
vehicle  with  locked  up  gears  has  a manual  transmission  and  a 
vehicle  with  unlocked  gears  has  an  automatic  transmission. 

UNIT  allows  the  user  to  specify  units  for  the  engine  data 
printout  resulting  from  a USE  or  ENGINE  command  in  units  other 
than  those  in  which  it  was  originally  input  on  the  disk  data  file. 
The  available  units  are  the  same  as  those  described  in  the  REMAP 
command . 

The  USE  command  allows  the  user  to  retrieve  data  from  the 
disk  parts  data  file.  The  model  will  ask  for  the  part  typed 
when  in  the  IA  mode. 

Valid  choices  are  the  following: 

(1)  ACCESSORY 

(2)  CONVERTER 

(3)  DRIVING  SCHEDULE 

(4)  ENGINE 

(5)  GEAR 

(6)  REAR  AXLE 

(7)  ROUTE 

(8)  SHIFT  LOGIC 

(9)  TIRES 

(10)  TRANSMISSION 

(11)  VEHICLE. 
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: The  program  will  then  ask  for  the  specific  part  name  (the 

name  originally  stored  on  the  disk  parts  data  file).  If  ENGINE 
is  specified,  the  user  must  specify  to  which  gears  and  to  which 
engine  number  the  engine  data  will  be  assigned.  An  example  of  an- 
engine  is 

"1  ENGINE  1 2 3"  (cr) 

(Note  that  the  read  format  is  I,A10,20I.) 

Be  sure  to  leave  enough  spaces  after  the  engine  name,  if  the 
name  is  shorter  than  10  characters.)  This  says  use  ENGINE  1 for 
the  first  engine  and  assign  to  it  gears  1,  2,  and  3.  In  the  case 
of  a 3-speed  car,  this  is  the  only  engine  that  should  be  loaded. 

The  program  will  ask  for  another  engine,  but  the  user  should  just 

■ 

type  a (cr) . In  some  cases  two  engine  maps  may  be  required  if,  “ 
for  example,  the  engine  calibration  is  different  in  gears  1 and  2 
from  the  calibration  in  gear  3. 

I 

To  load  gears,  use  the  TRANSMISSION  option.  The  user  will  be 
asked  for  a transmission  name  or  a (cr).  If  a transmission  part 
has  been  defined,  with  the  "TRANSMISSION”  command,  simply  name  the 
transmission.  If  not,  hit  the  (cr)  and  HEVSIM  will  ask  for  and 
load  all  your  gears  one  by  one.  At  any  point  after  gears  are 
loaded  the  user  may  change  a particular  gear  by  typing  "USE."  In 
answer  to  the  "part  type"  question,  type  "GEAR."  HEVSIM  will  ask 
which  gear  number  is  to  be  reloaded,  and  then  ask  for  the  name  of 
the  gear. 

ZERO  command  enables  the  user  to  zero  the  core  memory  data 
currently  stored  by  the  program,  and  reset  program  flags  and 
pointers.  In  the  case  of  accessory  data  the  program  accumulates 
A list  of  accessory  tables,  one  for  each  USE  command.  Unless  a 

ZERO  command  is  issued,  a new  set  of  accessories  would  be  added 

, 

to  the  old  set  rather  than  replace  them.  To  delete  from  core  any 
particular  accessory  while  in  IA  mode,  type  "ZERO  name"  (cr) 

(note  2 spaces  between  ZERO  and  name)  where  name  is  any  accessory 

name.  To  zero  all  parts,  just  type  "ZERO"  (cr) . 

I 

i 
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3.  SAMPLE  SIMULATIONS 


This  section  will  provide  sample  simulation  cases  illustrating 
the  four  methods  described  in  :the  previous  section.  Vehicle  parts 
for  sample  cases  are  included  in  Volume  III,  Appendices  II  and  III. 

3.1  INTERACTIVE  SIMULATION 

An  interactive  simulation  may  be  conducted  using  either  the 
ASK  or  TELL  option.  The  ASK  option  is  typically  more  convenient, 
since  the  user  is  prompted  for  all  necessary  information.  Al- 
though a simulation  may  be  conducted  using  the  TELL  option,  it 

was  provided  more  specifically  for  the  purpose  of  changing  parts 

✓ 

from  a previous  run  to  new  parts  for  the  next  run.  These  con- 
cepts  will  become  clear  from  the  sample  terminal  sessions. 

The  following  parts  must  reside  on  a disk  before  attempting 
to  use  them: 

(1)  engine  map  data 

(2)  gross  vehicle  data  (tires  and  rear  axle) 

(3)  torque  converter  tables  (one  for  drive  and  one 
for  coast) 

(4)  gear  box  data  (transmission  and  gears) 

(5)  a shift  logic 

(6)  a route  description 

(7)  a driving  schedule. 

Option  data  consists  of  accessory  tables  which  are  not  required 
but  may  be  included  if  desired.  If  a manual  transmission  is  re- 
quired, the  user  must  specify  that  all  gears  are  "locked  up." 

This  means  that  the  speed  and  torque  ratio  for  the  torque  con- 
verter will  be  set  to  unity.  In  addition,  of  course,  an  appropriate 
shift  logic  should  be  used. 

For  interactive  simulation,  a number  of  characters  have  been 
designated  to  perform  a few  key  functions  through  a program 
interrupt.  These  are  as  follows: 
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CTRL  D - TYPE  OUT  DEBUG  INFORMATION 
CTRL  E - CLOSE  ALL  FILES  AND  EXIT  TO  MONITOR 
CTRL  N - SUPPRESS  END  OF  DRIVING  SEGMENT  MESSAGES 
CTRL  P - PAUSE  TO  MODIFY  AND  THEN  CONTINUE  SIMULATION 
CTRL  S - TYPE  OUT  CURRENT  STATUS  OF  SIMULATION 
CTRL  0 - TURN  OFF  SIMULATION  OUTPUT  EXCEPT  FOR  ERROR 
MESSAGE. 

The  CTRL  abbreviation  indicates  the  teletype  terminal  con- 
trol key  is  to  be  depressed.  A carriage  return  is  indicated  by 
(cr)  throughout  this  section. 

3.1.1  Input 

A sample  of  an  interactive  terminal  session  input  is  shown 
in  Figure  2,  where  user  responses  are  underlined.  Initially 
HEVSIM  is  placed  in  the  ASK  mode.  After  completion  of  loading 
the  input  data,  a summary  status  report  is  typed  for  user  review. 
Any  modifications  to  the  parts  may  then  be  made.  Thus,  the  user 
can  reset  the  value  of  a number  of  individual  program  parameters 
as  illustrated  without  creating  a new  component  data  set  for  the 
disk  file. 

Once  the  parts  are  loaded  and  any  required  modifications  have 
been  made,  the  status  report  is  repeated  and  the  SIMULATE  query 
may  b<  ai  swered  affirmatively  to  begin  execution. 

3.1.2  Output 

The  default  output  includes  end  of  segment  time,  distance, 
speed,  CPU  time  in  the  segment,  and  total  CPU  time  (these  messages 
may  be  eliminated  using  CTRL  N) . The  default  output  and  the 
standard  summary  sheet  groups  information  into  five  clusters,  as 
shown  in  Figure  3.  The  first  cluster  shows  the  fuel  economy, 
engine  work  per  mile,  average  brake  specific  fuel  consumption,  and 
average  speed.  Note  that  if  an  emissions  simulation  were  being 
performed,  the  fuel  economy  number  would  show  the  recipricol  of 
the  emissions  (NO^  simulations  are  reasonable,  HC  and  CO  not 
recommended)  in  grams  per  mile  provided  the  specific  gravity  in 
the  engine  map  is  specified  as  0.1198. 
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RUN  HISTQG 


HISTCG  TRUCK  87  (£4i  l3-l£c-S8  1.5:  IS  JOB#  £1  rjYCib?  uSKE 

*TITLE 

ENTER.  RL*N  TITLE:  HEUSIM  INTERRCTTUE  DEMO:  BUS 
*OUTP!JT 

LPT  FILE  88  1USM . DhT-T  I SR:  DELETE 

l_PT  FILE  DSKB  : 8£iUSM.  DRTC03334?  6333 < 1 88  VIUSPOSE:  DELETE 

Enter  neu  output  file:  BUSBUGC3?33 

*RSK 


ENTER: 

NUMBER 

s Di- 

RCCESS 

ORIES  TO  BE  USED: 

1 

ENTER 

PRRT  NR 

me 

FOR  RC 

CESSORV  # i:  BUS 

> 

ENTER 

PRRT  NF 

ME 

OF  DR  I 

UE  CGNUERTER:  TO  B 

E USED:  T 

ENTER 

PRRT  NR 

ME 

OF  COR 

ST  CGNUERTER  TO  BE  USED:  T 

ENTER 

PRRT  NR 

ME 

OF  PRICING  SCHEDULE  TO 

PE  USED: 

ENTER 

ENGINE 

Nur 

lEERfl 

UP  £ 1 ? FhRT  NRME? 

RND  GERR 

: 1 6*. 

j9£  T H 

1 

o» 

d.  3 4 

ENTER 

a 

3 

ENGINE 

N!jr 

lEEPri 

OR  £i?  PRRT  NRME? 

RND  i sERR 

— KSTPT: 
E-J  1 I SUv 

PhRT  NR 

ME 

OF  ROU 

TE  TO  BE  USED:  ZG 

RRDE 

— f !Tr*T: 

***  i “ i r w 
— i > i i — 1 

PRRT  NRME 

OF  SHI 

FT  UJGlC  !U  BE  US 

ED:  U738- 

ENTER  PRRT  NRME  OF  'CHICLE  TO  BE  USED:  BUS-1 
ENTER  PRRT  NRME  OF  TIRE  TO  BE  USED:  BUS  1 

LMTER  PRRT  NR  Ml  uF  TRBNsMIssIuN  i.  uR  < UR  > FUK  UERRbJ  : u— T-iyB 
ENTER  RULE  NRME:  BUS-3 


FIGURE  2.  INTERACTIVE  SIMULATION  TERMINAL  SESSION 


HEUSIM  TRUCK  0?f£4:i  STATUS  REPORT 


DIALOGUE  MOPE  .-tty 

S I MULfiT I ON  MODE-TRUCK 

RUN  TITLE-H0JSIM  INTERRCTIUE  DEMO:  BUS 

ENGINE ( 1 ) -6U92TP 

DRIUE  CONUEETER-TC- i 88EF 

■ ..ijfioT  UUNUERTER-Tl;-49U-»  • 

UEHICLE-BUS-1 
AXLE  - BUS-2 


TRRNSMI 

SSI  ON  - (•-73 

8B 

GERE  # 

1-U730B-1 

ASSIGNED 

! 0 

ENGINE-6U92TA 

GERE  # 

2-U738E-2 

ASS  IgNED 

TO 

ENG INE-6U92TA 

GERE  # 

3-U738E-2A 

ASSIGNED 

TO 

ENG I NE-6U92T A 

GERE  # 

4_  U 7 -"0  B’ — d 
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TO 

ENG INE-RU92TA 

RCCESSORV  # I -BUS  1 

DR I U I NG  SCHEDULE-TR REUSCBDR 

SHIFT  L0GIC-U738-ST 

ROUTE-ZGRRDE 

TIRE-BUS  1 

■iO  GERES  LOCKED  UP 

GERES  UNLOCKED  - 1 2 3 4 

LIMIT  FRINT-SUMMR  8. 6888888E+88 

DFRI IG-OFF  8. 8888888E+88  8 . 8888868E+88 

TTY  OUTPUT-OFF 

LPT  OUTPUT-ON 

NO  MODIFICATIONS 

SIMULATE  ? (PNS  V..-rL-D ) : N 


i* 

.h 


'EF'  GEAR  NUMBERS 


TO  BE  LOCKED  UP: 


ENTER  GERE  NUMBERS  TO  BE 
*MOB I FV  i NEW  URLUE  ? I TEN  !i  : 
^MODIFY (NEW  URLUE? ITEM) : 
*MOD I FY ( NEW  > !RLUE ? J TEM ) : 
*LIMIT  PRINT:  SECON  .85 
: ‘Y  ijijTPIJ  i i.  lN FF . i : uFF 


UNLOCKED:  i £ 
.3E5? WEIGHT 


35  s REAR 


^ifc-JrUL’ 


OFF 


FIGURE  2.  INTERACTIVE  SIMULATION  TERMINAL  SESSION  (continued) 
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BUS 
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FIGURE  2.  INTERACTIVE  SIMULATION  TERMINAL  SESSION  (continued) 
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VEHICLE  PEPFOFfFNCE  SIMULATION  J5-I'ec-80 


,'UN  TITLE  = HEVSIM  INTERACTIVE  DENG:  BUS 


CHEDULE  AVERAGES 
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= 

U738-3T 

30000. 

STROKE  (INCHES) 

3 

5.08 

552.8 

REAR:  RYLE  RATIO 

= 

5.35 

0.00 

0.0 

FUEL  DENSITY  (LB^GRL) 

s 

7. 18 

U 


TIRES  = 16.80  > 8.6®  j 8.40  j 1.80 


TGTALS 

TOTAL 

FERCENT 

OF  TOTAL 

MARI ABLE 

(UNITS) 

AMOUNT 

(CFIJISE  ACCEL 

BECEL 

IDLE  ) 

TINE 

(SECS' 

40.3 

48.8  21.  A 

18. 3 

18.8 

DISTANCE 

(NILES) 

8. 1 

65.9  18.4 

•5.7 

8.8 

ENERGY 

(HP-HP) 

8.64 

31.2  68. 9 

4.5 

3«  4 

FUEL  * 

(LBS) 

8.26 

85.7  53.7 

5.5 

5. 1 

ENERGY  SUPPLY 

HP'— HR 

BREAKDOWN 


EXIT 


(1) 

ENGINE 

3 

8.64 

(2) 

KINETIC  ENERGY 

3 

0.00 

(3) 

POTENTIAL  ENERGY 

3 

0.00 

(4) 

ROTATING  INERTIA 

= 

. 0.00 

PERCENT 

ENGINE  HP- 

(1) 

ACCESSORIES 

= 

32.83 

(2). 

TORQUE  CCMUERTER 

3 

1.20 

(3) 

CLUTCH 

3 

0.  00 

(4) 

GEAR  BOX 

3 

2.03  • 

(5) 

DIFFERENTIAL 

3 

1.61 

(6) 

TIRE  SLIP 

= 

0.  00 

3 +4+5+6 

3 

3. 63 

2+3+4+S+6 

3 

4.83 

(?) 

AERODYNAMIC  DRAG 

3 

2. 25 

(8) 

ROLLING  RESIST 

3 

1 8. 06 

SUBTOTAL  8 

3 

59. 10 

(9) 

BRAKES 

3 

38.69 

(10) 

ENGINE  MOTORING 

3 

2.21 

SUBTOTAL  1-10 

3 

100.00 

(11) 

OTHER  ENERGY 

3 

0.  00 

TOTAL  1-11 

3 

100.00 

FIGURE  3.  VEHICLE  PERFORMANCE  SIMULATION 
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The  second  cluster  shows  the  totals  of  time,  distance,  engine 
energy,  and  fuel.  The  percent  of  each  total  is  partitioned  into 
amounts  used  during  cruise,  acceleration,  deceleration,  and  idle. 
The  fuel  used  during  braking  is  the  percentage  of  the  total  which 
is  consumed  during  closed  throttle  decleration. 

The  energy  supplied  to  the  vehicle  is  broken  down  in  the 
third  cluster.  Potential  and  kinetic  energies  and  rotating 
inertia  will  be  shown  for  certain  types  of  driving  schedules,  such 
as  simulating  an  upgrade  and  terminating  the  driving  schedule  at 
the  top  of  a grade. 

The  fourth  cluster  lists  the  percent  of  engine  work  consumed 
by  various  losses,  the  amount  of  engine  braking,  and  engine 
motoring.  Each  of  the  losses  is  broken  out  separately,  which 
provides  a convenient  way  to  assess  the  influence  of  improved 
components . 

Additional  run  data  is  presented  in  the  last  cluster,  which 
includes  key  vehicle  specifications  and  run  conditions.  With  the 
exception  of  aerodynamic  drag  and  tires,  the  additional  run  data 
is  self-explanatory.  The  aerodynamic  drag  information  shows  the 
cross-sectional  area  and  drag  coefficient,  while  the  tire  informa- 
tion lists  the  linear  term  of  the  rolling  resistance  equation 
(lb/100  lb) , the  velocity  dependent  term  (lb/1000  lb  per  MPH) , and 
the  tire  friction  (slippage)  factor  expressed  as  a decimal  per- 
centage . 

An  interactive  simulation  does  not  produce  a LOG  file  since 
the  terminal  output  is  a printed  copy.  A HEVSIM  data  file,  how- 
ever, is  generated  which  the  user  may  SAVE,  PRINT  or  DELETE  after 
a run. 
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3.1.3  Continuation  of  Interactive  Simulation 


After  the  first  interactive  simulation  has  been  completed, 
the  user  may  wish  to  change  a specific  component,  modify  a com- 
ponent, or  change  to  a completely  different  set  of  input  para- 
meters. Such  changes  are  readily  accomplished  through  the  USE 
commands.  A list  of  the  commands  necessary  to  change,  for 
example,  driving  cycle  and  rear  axle  ratio,  are  shown  in  Figure  4. 

A simulation  run  is  terminated  by  typing  EXIT  after  the 
summary  sheet  is  typed  on  the  terminals.  A program-generated 
HEVSIM  data  file  is  recorded  in  the  user's  disk  area  which  may  be 
(1)  APPENDed  to  the  HEVSIM  data  file  of  the  previous  case,  (2) 
SAVED,  which  destroys  the  HEVSIM  data  file  of  the  previous  case 
but  keeps  the  record  of  the  current  case,  or  (3)  DELETED,  which 
eradicates  the  current  case  record.  Normally,  APPEND  is  used 
until  after  the  final  case  when  the  user  then  selects  whether  to 
PRINT  or  DELETE. 

3.1.4  Dump  of  Parts  List 

Parts  data  may  be  listed  for  a particular  part,  all  the  parts 
within  a part  type,  or  the  entire  parts  file.  A listing  is  ac- 
complished through  the  DUMP  command  which  queries  the  user,  as 
shown  in  Figure  5.  Wild  characters  may  be  used  as  required  to 
list  a group  of  parts. 

The  user  also  has  the  option  to  obtain  a directory  of  all 
the  parts  within  a part  type  or  for  all  the  data  currently  stored 
in  the  disk  parts  data  file.  The  DIR  command  is  demonstrated  in 
Figure  6.  Wild  character  use  is  permitted  for  maximum  flexibility 
The  directory  will  only  be  typed  at  the  terminal  if  the  TTY 
switch  is  turned  on  (as  shown  in  Figure  5) . The  directory  which 
comes  to  the  terminal  is  a "fast"  directory,  that  is,  only  the 
part  name  will  be  printed.  The  print  file  directory  (which  auto- 
matically is  printed  during  the  DIRECTORY  command)  gives  a full 
directory,  that  is,  it  includes  the  part  name,  protection,  date 
created,  the  part  creator's  identification  code,  and  the  comment 
field  associated  with  each  part. 
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♦USE 

PftP.T  TYPE:  VEHICLE 

ENTER  PART  NAME  OF  VEHICLE  TO  EE  USEE*.  BUS-1 
PART  TYPE : 

♦MODIFY 

♦MDE I F Y NEW  VALUE  1 1 TEM  > : 3 . E4  , WE  I GHT 


►MODIFY 


NEW  VALUE  ? ITEM!-  : 


FIGURE  4.  INTERACTIVE  TERMINAL  SESSION  CONTINUATION 
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♦TTY 


TTY  OUTPUT CON'OFF} : Oh 
♦DUMP 

LUMP  TO  TTY? CANS  Y/TO  Y 

DO  YOU  WANT  fl  DIRECTORY  OF  PARTS  DUMPED? CRMS  Y^fO  * Y 
PART  TYPE:  VEHICLE 
EMTER  PART  MRME : BUS-1 


VEHIC  PARTS  LATA  FILE  DIRECTORY  7-Jftn-Sl  DSKB  * VSMVEH. BINE  03313 j 
3 


BUS-1 


VEHICLE  DATA  < EUS-1 


STANDARD  BUS 


WEIGHT  = £4600.0  LBS 

FRONTAL  AREA  = 75.00  SO.  FT  NUMBER  OF  TIRES 

DRAG  COEFFICIENT  = 0.600000  CD  SENSITIVITY  COEFF  = 

PROPSHAFT  INERTIA  = 0.000  FT-LB-SEC~£ 

BEVEL  GEAR  = 0.375?  BEVEL  GEAR  EFF . = 0.380 


= c. 

1 .000000 


A TOTAL  OF  1 VEHIC  PARTS  ON  FILE  DSKB  rVSMVEH .EINE 03313 »67£ 3 


FIGURE  5.  PARTS  LISTING  AT  TERMINAL 
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♦DIR 

PART  TYPE:  VEHICLE 
ENTER  PART  NAME*.  ♦ 


VEHIC  PARTS  LATA  FILE  DIRECTORY  7-Jr-iN-Sl  DSKB  iVSMVEH  .B INC  03313 » 672 


2CB2G1EGMF 

2DB2H1JGMS 

TCTD 

1AD1D1DIHC 

1AD2C1DIHF 

2DL2H1GWMC 

2CL2H1NIJMF 

1AD1D1DFDB 

1AD2C1CFDF 

EUC-1 

A TOTAL  OF  10  VEHIC  PARTS  ON  FILE  DCKB  SVSMVEH .DINt 03313 »672 3 


FIGURE  6.  PARTS  DATA  DIRECTORY 


3.2  BATCH  FILE  SUBMISSION  ATTACHED  SIMULATION 

A simulation  can  be  conducted  at  a terminal  by  entering  a 
HEVSIM  control  file  through  the  use  of  the  BATCH  command.  A 
sample  HEVSIM  control  file  is  shown  in  Figure  7.  Note  that  the 
^SIMULATE  commands  contains  a DIALOGUE  option  which  places  HEVSIM 
under  user  control.  Before  the  simulation  begins,  the  user  now 
has  the  option  to  type  SIMULATE  or  make  any  desired  modifications. 

Figure  8 shows  a sample  terminal  session  in  which  the  simula- 
tion was  started  immediately  after  the  control  file  was  loaded. 
Also  shown  is  the  use  of  the  CTRL  N interrupt  character  to  delete 
the  end  of  segment  messages.  The  first  simulation  summary  sheet 
was  typed  but  is  not  shown  here  since  it  is  the  same  as  in  the 
previous  example.  The  second  simulation  using  FTPR  driving 
schedule  would  begin  after  typing  the  CONTINUE  command.  A CTRL  N 
would  also  be  required  to  turn  on  the  end  of  segment  messages  if 
desired.  At  the  end  of  the  second  simulation  the  user  may  EXIT 
from  HEVSIM  or  go  on  with  another  case  by  switching  to  DIALOGUE 
mode  to  perform  an  interactive  simulation. 

3.3  BATCH  FILE  SUBMISSION  DETACHED  SIMULATION 

Three  files  are  needed  to  run  HEVSIM  in  batch.  They  are  as 
follows: 

(1)  Batch  control  file 

(2)  HEVSIM  control  file 

(3)  HEVSIM  data  base  file. 

The  batch  control  file  is  a simple  four-line  instruction 
for  running  HEVSIM,  as  shown  in  Figure  9:  it  tells  HEVSIM  which 

file  in  the  user's  area  is  the  HEVSIM  control  file.  A sample 
HEVSIM  control  file  is  also  shown  in  Figure  10.  A data  base  file 
is  a binary  file  generated  by  HEVSIM  (See  Section  5)  which  con- 
tains all  the  parts  data  to  run  a simulation.  This  binary  file 
can  be  read  only  by  HEVSIM  and  may  contain  a large  number  of 
parts  so  that  they  are  available  for  immediate  use  when  specified 
in  a HEVSIM  control  file. 
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♦OUTPUT 
♦LIMIT  PRINT 
♦TITLE 


HEVSIM  .DATC  3 ?3  ] 


TEST 


□FF 

CASES 


OF  TRUCKS  AND 


♦USE 

6V92TA 

ENGINE 

1 

♦USE 

TRREUSCED 

DRIVING 

♦USE 

BUS-2 

AY.LE 

♦USE 

V730-ST 

SHIFT  LOGIC 

♦USE 

ZGRADE 

ROUTE 

♦USE 

BUS  1 

TIRE 

♦USE 

V-730B 

TRANSMISSION 

♦USE 

BUS-1 

VEHICLE 

♦USE 

TC-490-C 

CONVERTER 

♦USE 

TC-100EF 

CONVERTER 

♦UNLOCK  CONVERTER 

GEAR 

1 £ 

♦LOCKUP  CONVERTER 

GEAR 

3 4 

♦LIMIT 

PRINT 

SEC 

0.05 

♦MODIFY 

WEIGHT 

30000 

♦MODIFY 

REAR 

c*  *tc - 

J ■ OJ 

♦SIMULATE 

BUS, 

♦USE 

TRAEUSCOM 

DRIVING 

♦SIMULATE 

BUS 

BUSES 
1 £ 


FIGURE  7.  SAMPLE  HEVSIM  CONTROL 
BATCH  ATTACHED  SIMULATION 


FILE  FOR 
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•LIMIT  print 
. •TITLE  --TEST 

orr 

CASES  OF  TRUCKS  1ND  BUSES 

•USE  6V92TA 
•USE  BUS  1 

ENGINE 

ACCESSORY 

i “ i 

2 3 4 

•USE  BUS-2 
•USE  V73»-ST 

AXLE 

SHIFT  LOGIC 

•USE  ZGRADE 
•USE BUS_i 

route 

TIRE 

' 

•USE  V«730B 
•USE  BUS-1 

TRANSMISSION 

VEHICLE 

•USE  TC-490-C 
•USE  TC-mnEF 

CONVERTER 

CONVERTER 

•UNLOCK  CONVERTER  GEAR 
•LOCKUP  CONVERTER  GEAR 

i 2 
3 4 

•limit  PRINT 
•MODIFY 

SEC 

WEIGHT 

o.os 

3ooOfl. 

• 

•MODIFY 

REAR 

S.3S 

END  OF  HEVSIM  CONTROL  FILE  DSK 
• 9DRL.DRI 

ITEST.SEV 

[03224*6331 

• 

•USE  TRABUSCBD 

DRIVING 

•simulate 

BUS 

[SIMULATING] 

_ CREACHED_INlTXAL-CbNDITIONSJ 


ESEGl 

1 CUMTI 

, 4.58  CUMD| 

0*.  006  MPHl 

10.0 

CPUS! 

1.43 

CPUTi 

1.51 

ESEGt 

2 CUMTI 

10.96  CUMDt 

0.032  MPH| 

20.0 

CPUS! 

1.80 

CPUTi 

3.33 

ESEGl 

3 CUMTI 

28.59  CUMD| 

0.130  MPHi 

20.0 

CPUSl 

0.16 

CPUTi 

3.50 

ESEGt 

4 CUMT| 

34.94  CUMD| 

0.147  MPHi 

0.0 

CPUS! 

1.20 

CPUTi 

4.72 

ESEGl 

5 CUMTI 

41.94  CUMDt 

Oil47  MPH| 

0.0 

CPUSl 

0.01 

CPUTi 

4.74 

ESCD| TRABUSCBD 

CUMTI  41.94  CUMDt  0 

.147 

MPGi 

4.1  CPUTi 

4.76 

FIGURE  8.  SAMPLE  INTERACTIVE  ATTACHED  SIMULATION  USING  BATCH 
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•ASSIGN  LPT : 1 
•RUN  HI ST DM 
♦BATCH  TEST  .SEV 
3DRI  .DR I 

• I F < ERROR. > .GOTO  ONE 
•GOTO  TWO 

□HE : : .CLOSE 
TWO : : 

• DELETE  HEVS I M . DAT[  3 • 3 3 

• PR  I NT.-B  I S : BEL  LOGS  . LOG 
. K JOB 


FIGURE  9.  SAMPLE  HEVSIM  CONTROL  FILE  FOR  DETACHED  SIMULATION 


♦□UTPUT  HEVS  I M . D ATC  3 .•  3 1 

♦LIMIT  PRINT  OFF 

♦TITLE  TEST  CASES  OF  TRUCKS  AND  BUSES 


♦USE  6V92TA 
♦USE  TRABUSCED 
♦USE  BUS-3 
♦USE  V730-ST 
♦USE  ZGRADE 
♦USE  BUS  1 
♦USE  V-730B 
♦USE  BUS- 1 
♦USE  TC-490-C 
♦USE  TC-100EF 
♦UNLOCK  CONVERTER  GEAR 
♦LOCKUP  CONVERTER  GEAR 
♦LIMIT  PRINT  SEC 

♦MODIFY  WEIGHT 

♦MODIFY  REAR 

♦SIMULATE  BUS, 

♦USE  TRAEU3CCM  DRIVING 
♦SIMULATE  BUS 


ENGINE 

DRIVING 

AXLE 

SHIFT  LOGIC 

ROUTE 

TIRE 

TRANSMISSION 

VEHICLE 

CONVERTER 

CONVERTER 


1 2 


1 £ 

3 4 
0 . 05 
3 0 0 0 0 


FIGURE  10.  SAMPLE  HEVSIM  BATCH  TEST. SEV  FILE 
FOR  DETACHED  SIMULATION 
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Output  from  a batch  job  is  written  to  a program-created  log 
file  for  printing  on  a line  printer.  A HEVSIM  data  file  is  also 
created  which  contains  additional  information  for  the  simulation. 

It  is  useful  to  print  it  if  an  abnormal  termination  of  the  run 
occurs.  This  HEVSIM  data  file  is  normally  eliminated  through  the 
delete  command  in  the  control  file,  as  shown  by  the  last  line  in 
Figure  9.  At  the  completion  of  a run  the  log  file  is  automatically 
printed  and  retained  in  the  user's  disk  area. 

The  print  options  previously  described  for  interactive  opera- 
tion may  also  be  used  in  batch  processing. 

3.4  BATCH  CARD  FILE  SUBMISSION 

Using  a card  deck  input  to  run  HEVSIM  assumes  that  the 
program  is  already  available  on  disk.  A sample  deck  listing  is 
shown  in  Figure  11.  The  card  deck  essentially  contains  a HEVSIM 
control  file  which  serves  as  input  data  to  run  HEVSIM.  The 
program  is  controlled  in  a manner  similar  to  a terminal  batch 
job,  except  for  the  use  of  cards. 

The  output  summary  sheet  is  shown  in  Figure  12.  A 50,000- 
pound  tractor-trailer  combination  unit  was  simulated,  which  is 
further  described  in  the  additional  run  data.  A parts  listing  for 
this  sample  case  is  included  in  the  Appendix  to  Volume  III. 
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$ JOB  NAMED--  ? Pi'iH 
$DECK  SAMPLE  * RUN 
SLIM IT  PRINT  OFF 

STITLE  SAMPLE  BATCH  HEVSIM  TRUCK  SIMULATION 


*USE 

LFAY2A 

ACCESSORY 

*USE 

EN34012H2 

ENGINE  1 

♦ USE 

C0CY2 

CONVERTER 

SUSE 

C0DY2 

CONVERTER 

SUSE 

SHORT HAUL 

DRIVING  SCHEDULE 

*USE 

ZGRADE 

ROUTE 

SUSE 

LM? 

SHIFT  LOGIC 

SUSE 

V2DB2HIN 

VEHICLE 

SUSE 

TX5001N12 

TRANSMISSION 

SUSE 

r I STD 1020 

TIRE 

SUSE 

R AS 751217 

AXLE 

SLOCK 

UP  CONVERTER 

GEAR  3 2 

SLIM IT  PRINT 

SEGMEN f 

♦MODIFY 

WEIGHT  50000 

SSI  MU 

LATE 

TRUCK 

TDECK 

SAMPLE ♦ CTL 

* RUN 

HEVSIM 

SB  A I C 

H SAMPLE, RUN 

♦EXIT 

* PR I NT  ??? VSM v DAI / 

'DISPOSE: DELETE 

STOPS 

10 

* SUBMIT  SAMPLE/AFTER:  23  : 00  : 00/TIME  : 01 : 30  : 00 

TEG  J 


7 8? 


FIGURE  11.  PUNCHED  CARD  LISTING  TO  EXECUTE  HEVSIM 


TOM  TITLE  = SAMPLE  BATCH  HEVSIM  TRUCK  SIMULATION 

SCHEDULE  AVERAGES.  _ FU-EL_  ECONOflY  _ = 5.39  HPG 

WORK  PER  MILE  = 2.79  HP-HR/HI 

AYG— SP  -EQ-EL-  CQHS  = 0.47  LBS/HP-HR 

AVG  SPEED  = 32.3  HP H 


ADDITIONAL  RUN  BATA 


DRXYING s CUSPS  LB.  -NAME  = SHORTHAUL  ROUTE  N AME =__££ RAPE 

VEHICLE  NAME  = V2DB2HIN  . ENGINE  NAHE  = EN34012H2 

CONVERTER  NAME  _=_CQBI2 SHIFT-  LOGIC  RAMS  = LH9  . 

WEIGHT  (LBS)  = 50000.  STROKE  (INCHES)  = 6.00 

..DISPLACEMENT  XCU  . Jim.— S Q55..3 REAR  JLXLS..BATIO  3.70 


WIND  VELOCITY  (HPH)  = 0.0  FUEL  DENSITY  (LB/GAL)  = 7.10 

AERO  DRAG  = 95.00  . 1.00 TIRES  = 6.75  . 0.07  . 0.95 

TOTALS  ’ TOTAL  PERCENT  OF  TOTAL 


VARIABLE 

(UNITS)-1 

AMOUNT 

fCRUISE 

ACCEL 

DECEL 

IDLE  ) 

«> 

TIME 

(SECS) 

6697.2 

87.8 

4.7 

3.0 

4.5  . 

DISTANCE 

ENERGY 

(MILES) 

fHP-HRl 

60.1 

167.85 

91.9 

85,7 

5.9 

14.0 

2.2 

0.2 

0.0 

0.2 

FUEL 

(LBS) 

79.20 

87.8 

11.0 

0.9 

0.4 

ENERGY  SUPPLY 

HP-HR 

--44)-  - ENGINE 

— 14-7-^85 

(2)  KINETIC  ENERGY  = 0.00 

44)  POTENTIAL  ENERGY  = 0.04 

(4)  ROTATING  INERTIA  * 0.00 


BREAKDOWN 


PERCENT  ENGINE  HP-HR 


(-1)-  ACCESSORIES = 0.56 

(2)  TORQUE  CONVERTER  = 0.03 

P)— GEAR-&Q3 d 2 >7.9 

(4)  DIFFERENTIAL  = 6.27 

(5)  TIRE  SLIP s 4.52 

3*4*5  = 13.57 

2±4±A±5. = 1 3.60 

(6)  AERODYNAMIC  DRAG  = 35.70 

(7)  ROT.T.TKG  RRSTST = 44.77 

SUBTOTAL  1-7  = 94.63 

(9)  ENGINE  HOTORING  = 0.84 

SUBTOTAL  1-  9 = 101.78 

(10)  OTHER  ENERGY  = 0.00 


TOTAL  1-10  = 101.7ft 


FIGURE  12.  SUMMARY  OUTPUT  FROM  PUNCHED  CARD  BATCH  SIMULATION 
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4.  INPUT  DATA  FORMAT 


The  precise  format  for  data  input  is  described  here  on  a 
line-by-line  basis,  and  is  indexed  to  numerical  card  (terminal) 
column  numbers.  Data  sheets  may  be  reproduced,  filled  out,  and 
submitted  directly  for  keypunching  or  remote  terminal  processing. 

4.1  DATA  FORMAT  SHEET  DESCRIPTIONS 

Input  data  for  the  program  is  punched  on  cards  according 
to  a specified  format,  and  then  read  onto  a disk  or  tape.  The 
data  format  is  provided  for  vehicle  parts,  specified  procedures 
and  utilities.  The  data  format  sheets  are  listed  below: 


PARTS  DATA 

PROCEDURES 

UTILITY 

(1) 

ACCESSORY 

(10) 

DRIVING  SCHEDULE 

(13) 

DEBUG 

(2) 

AXLE  (REAR) 

(11) 

ROUTE 

(14) 

DROP 

(3) 

ENGINE 

(12) 

SHIFT  LOGIC 

(15) 

DUMP 

(4) 

FULL  CONVERTER 

(16) 

LIMIT  PRINT 

(5) 

GEAR 

(17) 

LOCKUP  CONV 

(6) 

S.R.  CONVERTER 

(18) 

MODIFY 

(7) 

TIRE 

(19) 

PRINT  UNITS 

(8) 

TRANSMISSION 

(20) 

REMAP 

(9) 

VEHICLE 

(21) 

SIMULATE 

(22) 

TITLE 

(23) 

UNLOCK  CONV 

(24) 

USE 

(25) 

ZERO 

A brief  description  of  the  parts  data  and  procedures  is 
provided.  The  utility  formats  are  self-explanatory  and  their 
uses  are  discussed  in  Section  2. 

Each  line  on  a data  sheet  indicates  one  line  of  code  to  be 
punched  on  a card  or  typed  on  a terminal.  The  columns  of  a data 
field  within  a line  are  indicated  with  the  appropriate  column 
number.  Left - j us tifying  the  data,  which  is  always  entered  in 
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decimal  form,  facilitates  keypunching.  Alphabetic  names  or  symbols 
already  included  on  a data  line  must  also  be  keypunched  starting 
in  the  first  column.  Many  of  the  data  forms  indicate  repeated 
lines  of  data.  For  these  cases,  there  is  no  need  to  repeat  the 
title  line,  comment  line,  and  first  data  line.  Part  names  may  be 
made  up  of  letters  and  numbers  only  (no  symbols  or  special 
characters) . 

Specific  comments  concerning  the  data  sheets  are  as  follows: 

(1)  ACCESSORY  - The  accessory  data  is  specified  at  accessory 

RPM.  The  accessory  speed,  torque,  and  inertia  are  referenced  to 
the  engine  through  the  speed  ratio  (SR)  of  the  accessory  gearing 

or  pulley  arrangement.  The  SR  is  equal  to  the  accessory  speed 

divided  by  the  engine  speed.  Accessory  duty  cycle  is  a multiply- 
ing factor  to  account  for  the  average  accessory  operating  time 
with  respect  to  engine  operating  time.  The  duty  factor  values 
can  range  from  0 to  1.0. 

(2)  AXLE  (REAR)  - the  rear  axle  part  contains  data  describing 

axle  ratio,  efficiency,  and  spin  losses.  If  a dual  axle  truck 

is  under  consideration,  two  load  efficiencies  and  two  sets  of 
spin  loss  data  are  specified.  Header  cards  AXLE  1 and  AXLE  2 
are  used  for  each  set  of  spin  loss  data.  For  single  axle  vehicles, 
only  one  rear  axle  efficiency  is  specified  (AXLE  #1),  and  the 
SINGLE  AXLE  header  card  is  used  in  place  of  the  AXLE  1 header 
card.  The  spin  loss  data  include  up  to  20  points  by  using  two 
more  data  cards  per  axle. 

(3)  ENGINE ' - the  engine  data  may  be  specified  in  any  of  the 
units  as  indicated  by  the  choices  for  the  first  ENGINE  card  field. 

The  preferred  units,  however,  are  RPM,  TORQUE,  and  fuel  rate  in 
LB/HR.  Engine  motoring  data  must  be  included  (i.e.,  at  least 

one  negative  load  point  in  the  first  LOAD  POINT  data  field) . 

Exhaust  gas  emission  simulation  (not  recommended  except  for  no  ) 

X 

is  provided  for  by  using  the  above  mentioned  preferred  units  in 
the  ENGINE  data  card,  a fuel  specific  gravity  of  0.1198,  and 
entering  emissions  data  (gm/hr)  in  the  FUEL  RATE  data  fields,-  The 
results  of  a simulation  will  produce  the  inverse  of  the  sought 
after  gm/mi  emissions,  and  will  show  this  inverse  as  the  fuel  economy 
in  the  summary  sheet. 
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(4)  FULL  CONVERTER  - torque  converter  data  for  both  a DRIVE 
and  a COAST  converter  must  be  provided  even  in  the  case  of  a 
manual  transmission.  The  data  cards  are  straightforward.  Manual 
transmissions  are  considered  as  a locked-up  torque  converter. 


(5)  GEAR  - gears  must  be  loaded  into  the  parts  data  file 
separately.  A transmission  is  made  up  of  a collection  of  gears 
which  may  have  the  same  spin  loss  data  as  the  entire  transmission. 
The  gear  input  inertia  includes  the  rotational  inertia  of  the  in- 
put shaft  and  attached  drive  gear,  while  output  inertia  is  the 
rotational  inertia  of  the  gear  under  specification. 

(6)  S.R.  CONVERTER  - serves  the  same  function  as  the  FULL 
CONVERTER.  The  torque  converter  data  is  specified,  however,  by 
input  speed,  speed  ratio,  and  torque  ratio.  Essentially,  this  is 
an  optional  way  to  specify  torque  converter  data. 


(7)  TI RES  - all  tires  on  a vehicle  are  considered  to  be  of 
the  same  type.  The  coefficients  Cl  and  C2  are  rolling  resistance 
coefficients.  A second  order  equation  is  used  to  approximate 
rolling  resistance  force,  which  may  be  made  linear  by  setting  C2 
equal  to  zero.  The  coefficients  are  to  be  specified  in  pounds 
force  per  1,000  pounds  vehicle  weight.  A tire  efficiency  term 

is  a multiplicative  factor  which  may  be  used  to  adjust  for  tire 
slip  . 

(8)  TRANSMISSION  - the  transmission  part  is  simply  a list 
of  gears  used  in  the  transmission.  The  gears  listed  must  either 
be  already  in  the  data  base  as  individual  gear  parts,  or  loaded 
as  gear  parts  along  with  the  transmission.  The  transmission  part 
mav  contain  a maximum  of  20  gears  . Once  the  transmission  part  and 
jjear?  are  loaded  into  the  data  base,  all  the  gears  used  in  the 
transmission  are  entered  collectively  as  the  transmission  part 
during  a simulation.  This  eliminates  the  string  of  gears  to  be 
typed  in  during  interactive  simulation.  The  feature  cf  modifying 
a gear  in  the  transmission  still  remains  functional  through  the 
USE  command. 
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(9)  VEHICLE  - the  vehicle  part  contains  basic  characteristics 
of  the  vehicle  such  as  weight,  drag  coefficient,  frontal  area,  and 
number  of  tires  on  the  road.  The  Cd  sensitivity  coefficient  is  a 
factor  used  only  when  investigating  yaw  effects  in  a cross  wind 
simulation.  Normally  this  factor  is  set  at  zero:  it  is  further 

described  in  the  mathematical  analysis  in  Volume  1.  Bevel  gear 
ratio  and  efficiency  can  be  specified  for  "V"  drive  bus  drive- 
trains.  If  bevel  gear  information  is  left  blank,  a default  value 
of  one  is  used  for  both  gear  ratio  and  efficiency. 

(10)  DRIVING  SCHEDULE  - the  course  of  accelerations,  cruises, 
decelerations,  and  stops  are  specified  in  the  driving  schedule. 

The  courses  may  be  initiated  at  other  than  zero  conditions  on  the 
INITIAL  COND  card;  and,  an  application  of  this  option  would  be  a 
constant  speed  cruise. 

Data  in  each  SEGMENT  is  grouped  according  to  which  data  may 
be  specified  as  only  one,  optional,  or  at  least  one.  For  the 
latter  type  of  data,  whichever  condition  is  satisfied  first  will 
terminate  the  segment. 

(11)  ROUTE  - the  route  specification  is  used  to  indicate 
distances  and  driving  conditions.  Maximum  flexibility  is  provided 
for  driving  conditions  by  allowing  them  to  be  changed  from  one 
MILEPOST  to  the  next.  The  ROUTE  specification  and  DRIVING  SCHEDULE 
must  be  checked  for  compatibility  when  grades  and  winds  are 
utilized.  For  example,  one  would  not  specify  a 75.  MPH  speed  on 

a 5.  percent  grade  with  a 50.  MPH  headwind  for  a 50,000  pound 
truck.  GRADE  changes  must  not  exceed  1.  percent  incremental 
changes  for  heavy  duty  trucks.  WIND  SPEED  may  be  specified  as 
either  positive  or  negative  for  head  winds  or  tail  winds, 
respectively.  Cross-winds  may  also  be  considered,  but  will  not  be 
discussed  at  this  time  due  to  wind  data  limitations  and  the 
unresolved  question  of  applicability. 

(12)  through  (25)  - data  forms  for  the  utility  commands  have 
the  same  effect  as  described  in  Section  2.2  and  2.3. 
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4.2  DATA  SHEETS 


The  data  sheets  for  parts  data,  procedures,  and  utility  com- 
mands are  described  in  this  section.  The  format  of  the  data 
sheets  is  similar  to  standard  keypunch  coding  forms.  Each  part 
is  described  on  a separate  sheet  with  mandatory  key  words  or 
phrases  already  indicated  on  the  sheet.  Each  new  part  begins  with 
an  asterisk  in  column  one  of  the  first  line,  followed  by  the  type 
of  part,  procedure  or  utility  command.  The  remaining  spaces  are 
to  be  filled  in  with  data  where  indicated  by  explanations  on  each 
form. 
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DATA  SHEET  1.  ACCESSORY 
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DATA  SHEET  2.  REAR  AXLE  (Sheet 
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DATA  SHEET  2.  REAR  AXLE  (Sheet 
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DATA  SHEET  3.  ENGINE  (Sheet  1 of  2) 
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DATA  SHEET  3.  ENGINE  (Sheet  2 of  2) 
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Increasing  load,  fill  spaces  with  data 

points  as  needed  up  to  20  points  maximum  Units:  throttle 
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DATA  SHEET  5.  GEAR 
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DATA  SHEET  6.  SPEED  RATIO  CONVERTER 
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DATA  SHEET  7.  TIRE 
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♦Tire  slip  effect  due  primarily  to  road  surface 

9 

*Bearing  Loss  Coefficient,  default  value  of  0.0004 


DATA  SHEET  8.  TRANSMISSION 


on 

lij  o or  x 

Q_  C\J  <X.  <X. 
LlJ  LiJ  T 


CC  C3 


47 


DATA 


DATA  SHEET  9.  VEHICLE 
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DATA  SHEET  10.  DRIVING  SCHEDULE  (Sheet  1 of  2) 
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DATA  SHEET  10.  DRIVING  SCHEDULE  (Sheet  2 of  2) 
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DATA  SHEET  11.  ROUTE 
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REPEAT  4 -CARO  SETS  AS  NEEDED  UP  TO  10  SETS  (100  points  maximum) 


DATA  SHEET  12.  SHIFT  LOGIC  (Sheet  1 of  2) 
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5.  HEVSIM  AND  PARTS  GENERATION 


The  information  provided  here  is  not  necessarily  user  oriented 
since  it  has  to  do  with  generation  of  a HEVSIM  core  image  file  and 
parts  file.  Normally  a user  will  not  have  to  perform  these 
functions,  or  may  intentionally  be  denied  the  opportunity  to  do  so. 

5.1  GENERATE  CORE  IMAGE  FILE 

Figure  13  shows  the  card  deck  listing  to  generate  a sharable 
HEVSIM  core  image  file  with  the  HEVSIM  source  listing  on  magnetic 
tape . 

5.2  GENERATE  PARTS  FILE 

The  deck  listed  in  Figure  14  shows  the  control  card  setup 
needed  to  use  the  HEVSIM  object  deck  (stored  on  a previous  run  as 
a permanent  disk  file)  to  create  and  store  permanently  on  disk  a 
new  parts  data  file. 

This  deck  is  also  used  to  add  new  parts  to  the  currently 
existing  old  parts  file  Calso  placed  on  disk  by  a previous  run) . 

The  use  of  a temporary  data  file  allows  the  user  to  keep  the  same 
physical  name  (i.e.,  PARTS)  for  the  parts  file.  The  parts  which 
can  be  loaded  correspond,  of  course,  to  the  parts  data  and  pro- 
cedures previously  described  on  the  data  input  sheets.  The 
commands  for  inputting  parts  data  contain  the  unique  name  of  the 
part  beginning  in  column  19  of  the  first  card  for  each  part.  The 
commands  are  listed  as  follows: 

*ENGINE  - indicates  that  engine  data  is  to  follow. 

*FULL  CONVERTER  - indicates  that  torque  converter  data  is  to 
follow  specifying  input  and  output  torques  and  RPM’s. 

*S.R.  CONVERTER  - indicates  that  torque  converter  data  is  to 
follow  specifying  input  torque  and  RPM  and  speed  and  torque  ratio. 

^VEHICLE  - indicates  that  gross  vehicle  data  (CD,  weight, 
etc.)  is  to  follow. 
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^SEQUENCE  XXXX 
$JQE  NRMEC  P ? PN  3 
SPRSSWORD 
SDECK  HEVS I M . CTL 

. MOUNT  MTfi  : VS  IV  FEEL  I E : HEVS  I N- ' V I D : 9 TRK  HEVS  I M TRF'E 
.REWIND  VSM : 

. COPY  HEVS I M . FOR=VSM : 

.COPY  Mfl I N . MRC=VSM : 

. COPY  CONNS . FOR=VSN : 

. COPY  VSNHLF . HLP=VSN : 

.DISMOUNT'  VSN: 

. LORD  NR I N . MRC > HEVS I N . FOP 

.SSRVE  HEVS IN 

I TOPS 10 

.SUBMIT  HEVS IN 

SEOJ 


-•WL 


FIGURE  13.  PUNCHED  CARD  LISTING  TO  GENERATE  HEVSIM  CORE  IMAGE  FILE 
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$ sequence  xxx 

SJlJE  NAMEC  P * F'N  3 
SPASSUQRD 
I DECK  PARTS. RUN 
insert  HEVSIM  parts  data  here 
SDECK  PARTS. CTL 
.RUN  HEVSIM 
♦BATCH  PARTS. RUN 
♦EXIT 

. PR  I NT  ???VSM  . DAT  •-  D I S : DELETE 
STEPS 1 0 
.SUBMIT  PARTS 
SEDJ 


FIGURE  14.  PUNCHED  CARD  LISTING  TO  GENERATE  PARTS  DATA  FILE 
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*GEAR  - indicates  that  data  for  a single  gear  is  to  follow. 

^ACCESSORY  - indicates  that  data  for  an  engine  accessory  is 
to  follow. 

*SHIFT  LOGIC  - indicates  that  the  shift  criteria  (shift  lines, 
shift  time,  etc.)  is  to  follow  for  all  gears  in  the  transmission. 

*TIRE  - indicates  that  data  for  a tire  type  is  to  follow. 

*REAR  AXLE  - indicates  that  rear  axle  data  is  to  follow. 

^TRANSMISSION  - indicates  that  a transmission  part  name  will 
follow  (specifies  a list  of  gears) . 

*DRIVING  SCHEDULE  - indicates  that  data  describing,  in  seg- 
ment form,  the  particular  driving  schedule  to  be  simulated  is  to 
follow. 

*R0UTE  - indicates  that  data  describing  the  physical  route 
to  be  driven  is  to  follow;  the  grade  and  road  coefficient 
specifications  are  from  the  last  data  point  milepost  to  the 
current  one. 

If  a part  is  to  be  input  using  the  same  unique  name  as 
already  appears  in  the  disk  data  file,  the  request  to  store  onto 
disk  is  ignored. 


300  copies 
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